home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Collections: Franz PD
/
Franz PD Disk #170 (1992)(Rhein-Sieg-Soft).zip
/
Franz PD Disk #170 (1992)(Rhein-Sieg-Soft).adf
/
map_editor
/
Map_Editor_Anleitung
< prev
next >
Wrap
Text File
|
1992-04-13
|
21KB
|
577 lines
***************************************************************************
* *
* Map Editor V1.0 (13.09.1991) *
* *
* (c) 1990-91 Robert Mueller & Matthias Lampe *
* *
***************************************************************************
***************************************************************************
* D E U T S C H E A N L E I T U N G *
***************************************************************************
WICHTIG: Dies ist kein PD-Programm; alle Rechte an dem Programm liegen
weiterhin bei den Autoren, allerdings darf das Programm zu
den unten genannten Bedingungen frei kopiert werden.
Das Programm darf frei kopiert werden, so lange dies nicht kommerziell
(d.h. wenn nur fuer Verpackung und Versand der Disketten Geld verlangt
wird, um die Unkosten zu decken - allerdings sind 5 (fuenf) Deutsche
Mark das absolute Maximum) erfolgt und alle Dateien (inklusive der
Anleitung) zusammen kopiert werden.
Jede kommerzielle Nutzung des Programms ist untersagt.
Die Autoren dieses Programms sind fuer keine Schaeden verantwortlich, die
durch die Benutzung dieses Programms entstehen.
Fehler, Verbesserungsvorschlaege,... koennen an folgende Adresse geschickt
werden:
Robert Mueller
Lichtenbergstr. 21
W-7778 Markdorf
[Deutschland]
^^ nur wenn Sie von außerhalb Deutschlands schreiben
(Anmerkung: Das 'W' vor der Postleitzahl ist eine Uebergangsregelung
der Bundespost zur Unterscheidung der Postleitzahlen der neuen und
der alten Bundeslaender)
Wir koennnen nicht versprechen, daß ihr auf euren Brief eine Antwort erhaltet,
da man als Student auch noch andere Dinge zu tun hat...
Jedenfalls waere es nett Rueckporto beizulegen, wenn ihr eine Rueckantwort
erwartet.
Natuerlich haben wir auch gegen Geldsendungen nichts einzuwenden, obwohl
nicht anzunehmen ist, das wir durch dieses Programm reich werden...
Uebersicht:
==========
Dies ist ein Editor um eine bis zu 320*256 Felder grosse Landschaft mit
bis zu 256 Landschaftselementen zu erstellen.
Dieser Editor ist zur Unterstuetzung bei der Programmierung eines
Fantasy- oder Strategiespiels in der Art von Ultima,... gedacht.
Features:
=========
- Laeuft jetzt auch ohne Interlace auf NTSC-Amigas
- MULTITASKINGFAeHIG, BETRIEBSYSTEMKONFORM (d.h. das Programm sollte
unter allen Kickstartversionen laufen)
- Konfigurationsdatei fuer den Editor
- Eingebaute Konvertierroutine fuer: IFF-Pinsel --> Bitmap-Format
(IFF.Library wird benoetigt)
- eingebaute Konvertierroutine fuer: Bitmap-Format --> Editor-Grafik-Format
- Block zeichnen
- Paste-Funktion
- Spraydose
- automatisches/manuelles Elementcycle (d.h. Wechsel gleicher Elemente)
- Mouse-Edit-Mode
- Fast-Mode (schnellere, nicht detaillierte Grafikanzeige)
- Gesamtkarten-Edit-Mode
- RAM-Save
- Undo
- Speichern einer Landschaft als IFF-Bild. (IFF.Library wird benoetigt)
Infos fuer Programmierer:
========================
1. Grafikelemente
-----------------
Der Bildschirm des Editors ist LORES (320*256) mit bis zu 32 Farben.
Als Font wird Topaz8 benoetigt (ist zur Zeit im ROM vorhanden, und somit
kein Problem)
Die Landschaftsgrafiken muessen als IFF-Pinsel (Brush) mit der Groesse
256*256 gespeichert sein, und folgendermassen angeordnet werden,
wobei jede Grafik 16*16 gross sein muss und 2-5 Bitplanes haben kann:
16 Reihen, mit jeweils 16 Grafiken
(--> Breite und Hoehe des Pinsels jeweils 256 Pixel).
-----------------------------------------------------------------
| 1| 2| 3| 4| 5| 6| 7| 8| 9| 10| 11| 12| 13| 14| 15| 16|
-----------------------------------------------------------------
| 17| 18| 19| 20| 21| 22| 23| 24| 25| 26| 27| 28| 29| 30| 31| 32|
-----------------------------------------------------------------
....
-----------------------------------------------------------------
|241|242|243|244|245|246|247|248|249|250|251|252|253|254|255|256|
--^--------------------------------------------------------------
|
Nummer des Landschaftselements
Sollten Sie weniger als 256 Landschaftselemente haben, fuellen Sie
die freien Stellen einfach mit irgendeiner Farbe oder Grafiken auf.
Diese Grafik muss dann als 256*256 grosser Pinsel gespeichert werden.
Diesen Pinsel muss man dann mit einem IFF-Converter in Bitmap-Format
konvertieren (Der Editor kann dies uebrigens auch - allerdings wird die
IFF.Library benoetigt, diese befindet sich auf Fish-Disk Nr. 301)
Bitmapformat (je nach Tiefe des Bildschirms):
1. Bitplane der gesamten Grafik
2. Bitplane der gesamten Grafik
3. Bitplane der gesamten Grafik
4. Bitplane der gesamten Grafik
5. Bitplane der gesamten Grafik
Dieses Bitmapformat wird dann in ein spezielles Format fuer den Editor
konvertiert (dies erledigt der Editor, dafuer wird die IFF.Library
nicht benoetigt).
Zum besseren Verstaendis sind auch die Grafikdateien beigefuegt.
Beigefuegt sind folgende Dateien:
- Brush.iff - IFF-Grafiken der oben genannten Anordnung
- Elements.bit - Editorgrafiken im Bitpmap-Format
- Editor_Elements.gxf - Grafiken im Eigenformat des Editors
- Map.dat - Mit diesen Grafiken erstellte Karte
- Map_Editor.config - Konfigurationsdatei fuer den Editor
- Map_Editor.doc - Diese Anleitung
- Map_Editor - Der Editor
2. Das Format der gespeicherten Landschaft
------------------------------------------
Die Landschaftsdatei hat folgendes Format:
2 Bytes - Breite der Landschaft
2 Bytes - Hoehe der Landschaft
folgende Bytes - Landschaftsdaten (1 Feld = 1 Byte)
1. Zeile (Spalte 1-Landschaftsbreite)
2. Zeile (Spalte 1-Landschaftsbreite)
3. Zeile (Spalte 1-Landschaftsbreite)
...
Hoehe der Landschaft. Zeile (Spalte 1-Landschaftsbreite)
Programmstart:
==============
Zuerst muessen Sie die Konfigurationsdatei ihren Wuenschen anpassen (s.u.).
CLI: Einfach 'Map_Editor' eingeben (gegebenenfalls vorher das Verzeichnis
wechseln)
Durch den Aufruf
Map_Editor CNF=<Pfad+Name einer alternativen Konfigurationsdatei>
koennen Sie den Editor veranlassen eine andere Konfigurationsdatei
zu lesen.
Workbench: Einfach das Icon des Programms anklicken
Um einen ersten Einblick in den Editor zu erhalten, geben Sie auf die
Frage 'Convert graphics?' 'Nein' ein und antworten Sie auf die Frage
'Load map' mit 'Ja'.
Die Beispiellandschaft wird geladen, und Sie nun etwas experimentieren.
Die Konfigurationsdatei:
========================
Der Editor sucht nach dem Programmstart nach der Datei Map_Editor.config
im aktuellen Verzeichniss und danach im S:-Verzeichnis.
Sollten Sie eine alternative Konfigurationsdatei angegeben haben, so
wird zuerst diese gesucht, und falls diese nicht gefunden wird,
nach den oben genannten Dateien gesucht.
Mit dieser Konfigurationsdatei koennen Sie den Editor Ihren Wuenschen anpassen.
Dazu muessen Sie diese Datei mit einem ASCII-Editor laden und aendern.
Ein '*' am Anfang einer Zeile kennzeichnet eine Kommentarzeile.
Eine Option wird folgendermassen gesetzt: #<OPTION><=PARAMETER>
Die gelesenen Optionen und eventuelle Fehler in der Konfigurationsdatei
werden auf dem CLI-Screen, bzw. beim Start von der Workbench auf einem
eigenen Window ausgegeben.
Optionen:
---------
#MAP=<Dateiname mit Pfadangabe>
Dies setzt den Namen der Datei, in der die Daten der Landschaft
gespeichert werden.
(siehe auch: 2. Das Format der gespeicherten Landschaft
Default: Map.dat
Beispiel: #MAP=Daten:karten/Fantasykarte
#EDITOR_ELEMENTS=<Dateiname mit Pfadangabe>
Dies setzt den Namen der Datei, in der sich die speziellen Grafikdaten
fuer den Editor befinden.
(siehe auch: 1. Grafikelemente)
Default: Editor_Elements.bit
#ELEMENTS=<Dateiname mit Pfadangabe>
Dies setzt den Namen der Datei, in der sich die Grafikdaten im
Bitmap-Format fuer den Editor befinden (diese Daten werden vom
Editor in ein spezielles Format konvertiert und in der mit
#EDITOR_ELEMENTS gestzten Datei gespeichert)
(siehe auch: 1. Grafikelemente)
Default: Elements.bit
#GFX=<Dateiname mit Pfadangabe>
Dies setzt den Namen der Datei in der sich die Grafikdaten als
IFF-Pinsel befinden.
(siehe auch: 1. Grafikelemente)
Default: Elements.iff
#IFFMAP=<Dateiname mit Pfadangabe>
Dies setzt den Namen der Datei, in der die Gesamtkarte als
IFF-Bild gespeichert wird.
(Siehe auch: Die Programmbedienung)
Default: Map.iff
#COLOR=<nr>,<rot>,<gruen>,<blau>
Dies setzt die RGB-Werte einer Farbe, wobei nr die Nummer der
Farbe (von 0-(2^tiefe-1) ) ist und rot/gruen/blau der Wert
der jeweiligen Farbe ist (von 0-15).
Default: -----
Beispiel: #COLOR=0,15,15,15 wuerde die Farbe 0 auf weiss setzen.
#BLACK=<nr>
Dies setzt die Nummer der Hintergrundsfarbe des Editors (Vorzugs-
weise Schwarz), wobei nr Werte von 0 bis 2^tiefe-1 annehmen kann.
Dies ist noetig, damit der Editor (da ja jeder Benutzer eigene
Farben setzen kann) eine brauchbare Farbdarstellung erhaelt.
Default: 0
#PEN1=<nr>
Wie #BLACK, allerdings setzt diese Anweisung die Nummer der
Zeichenfarbe
Default: 3
#PEN2=<nr>
Wie #PEN1, allerdings setzt diese Anweisung die Nummer der
Zeichenfarbe, die zur Hervorhebung benutzt wird.
Default: 2
#CYCLE=<nr>,<von>,<bis>
Damit legen Sie den Cycle-Bereich fest, der bei 'Cycle auto' benutzt
wird (siehe Erklaerung weiter unten).
<nr> kann Werte von 0 bis 9, <von> und <bis> Werte von 0 bis 255
annehmen, wobei <von> kleiner als <bis> sein muss.
Default: ----
#UNDO=TRUE/FALSE
Dies aktiviert die Undo-Funktion (TRUE) bzw. deaktiviert sie (FALSE)
beim Programmstart.
Beachten Sie, daß diese Funktion zusaetzlichen Speicher benoetigt.
(Siehe auch: Die Programmbedienung)
Default: FALSE
#RAMSAVE=TRUE/FALSE
Dies aktiviert die RAM-Save-Funktion (TRUE) bzw. deaktiviert
sie (FALSE) beim Programmstart. Diese Funktion ermoeglicht es, eine
Karte im RAM zu speichern (nicht in der RAM-Disk!!!).
Beachten Sie, daß diese Funktion zusaetzlichen Speicher benoetigt.
(Siehe auch: Die Programmbedienung)
Default: FALSE
#SPRAY=TRUE/FALSE
Dies aktiviert die Spray-Funktion (TRUE) bzw. deaktiviert sie (FALSE)
beim Programmstart.
(Siehe auch: Die Programmbedienung)
Default: FALSE
#PASTE=TRUE/FALSE
Dies aktiviert die Paste-Funktion (TRUE) bzw. deaktiviert sie (FALSE)
beim Programmstart.
Diese Funktion wird eigentlich nie benoetigt.
(Siehe auch: Die Programmbedienung)
Default: FALSE
#CYCLEMODE=FALSE/TRUE/AUTO
Dies schaltet die Cycle-Funktion beim Programmstart aus (FALSE),
an (TRUE) oder auf Automatik (AUTO).
(Siehe auch: Die Programmbedienung)
Default: AUTO
#FAST=TRUE/FALSE
Dies schaltet den Fast-Modus beim Programmstart ein (TRUE) bzw.
aus (FASLE). Bei #FAST=TRUE wird bei Blockoperationen in den
Karten die Grafik schneller aufgebaut.
Default: TRUE
#INITELEM=<nr>
Dies setzt die Nummer (0-255) des Elements, das benutzt werden soll,
um die Landschaft zu loeschen.
Default: 0
#ELEM=<nr>
Dies setzt die Nummer des Elements, das bei Programmstart das
Zeichenelement sein soll.
Default: 0
#DEPTH=<tiefe>
Diese Option setzt die Tiefe des Editors (maximale
Farbanzahl = 2^tiefe)
Beachten Sie, das die Tiefe der Tiefe ihrer Grafiken entsprechen
muss!!!
Dieser Wert beeinflusst auch die Optionen #COLOR, #BLACK, #PEN1
und #PEN2.
Default: 5
#NTSC=TRUE/FALSE
Wenn Sie einen NTSC-Amiga haben, sollten Sie #NTSC=TRUE setzen -
wenn Sie einen PAL-Amiga haben, setzen Sie #NTSC=FALSE
Default: FALSE
(Hinweis: Die Option #INTERLACE wird nicht mehr unterstuetzt)
#INITELEMCOLOR
Setzt die Farben fuer die Elemente fuer die Darstellung in der
Gesamtkarte auf den mit #BLACK eingestellten Wert.
Bevor Sie diese Option benutzen, sollten Sie mit #BLACK und #COLOR
die Farben gesetzt haben.
#ELEMCOLOR=<elemnr>,<farbnr>
Setzt die Farbe, die fuer ein Element in der Gesamtkarte benutzt wird,
wobei elemnr Werte von 0-255 und farbnr Werte von 0 bis 2^tiefe-1
annehmen kann.
Bevor Sie diese Option benutzen, sollten Sie #INITELEMCOLOR aufrufen.
Beispiel:
Z.B. ein Wiesenelement hat die Elementnr. 4 und Sie wollen dieses
Feld in der Gesamtkarte gruen (Farbnummer sei 5) darstellen, dann
bewirkt dies die Option #ELEMCOLOR=4,5.
#QUIET
#NORMAL
#VERBOSE
Dies wirkt sich nicht auf den Editor aus, sondern auf die Ausgabe
der Konfigurationsdaten auf dem CLI-Window.
#QUIET - keinerlei Textausgabe
#NORMAL - nur Fehlermeldungen werden ausgegeben
#VERBOSE - Fehlermeldungen und Konfigurationsdaten werden ausgegeben.
Default: #NORMAL
#EOF
Dies markiert das Ende der Konfigurationsdatei (muss nicht unbedingt
gesetzt werden)
Die Programmbedienung:
======================
Nach dem Programmstart:
-----------------------
Die Konfigurationsdatei wird gelesen und die Daten auf dem CLI-Schirm
ausgegeben.
Danach erscheint der Editor und Sie muessen entscheiden, ob Sie
Grafiken ('Convert graphics?') konvertiern wollen.
Falls ja:
Nun muessen Sie noch angeben, ob Sie einen IFF-Pinsel konvertieren
wollen ('IFF->Bitmap?'). Anworten Sie mit ja, dann wird der IFF-Pinsel
geladen und konvertiert (erst in Bitmap, dann in das Editorformat),
andernfalls wird eine im Bitmap-Format vorliegende Grafik konvertiert.
Hinweis: Um IFF-Pinsel zu konvertieren brauchen Sie die IFF-Library
von Fisk-Disk301.
Falls nein:
Der Editor laedt die vorliegenden Editor-Grafiken nach.
Nun muessen Sie angeben, ob Sie eine bestehende Landschaft laden wollen.
Falls ja, wird die Landschaft geladen, falls nein, muessen Sie die Groesse
der neuen Landschaft eingeben.
Das Main-Display/Haupteditiermodus:
-----------------------------------
-------------------------------------------------------------------------
| Verfuegbare Grafiken (weiterblaettern der Grafiken mit + oder -, |
| auswaehlen mit der Maus) |
| |
| |
-------------------------------------------------------------------------
| gewaehltes Element --> ** 4,4 <-- Koordinaten |
| | ** Paste off <-- Paste-Funktion aus |
| Auschnitt aus der | Spray off Cycle off <-- Spray und Cycle aus |
| momentanen Landschaft | x1,y1 : 0,0 <-- Koord. der 1. Blockecke |
| Scrollen mit dem | cel1-cel2 : 0-3 <-- Bereich des Elementcycles |
| Zehnerblock | -----------------------------------------------
| Zeichnen mit Maus oder| |
| Leertaste | FREI FUeR MELDUNGEN |
| | |
| | //// Fast-Modus aktiviert |
| | -FAST------------------------------------------
| | |
| | /// Landschaft wurde veraendert |
---------------------------MOD-------------------------------------------
Tastaturbelegung:
Zehnerblock - Scrollen des Auschnitts
SPACE oder 0- Setzen des Elements unter dem Cursor
P oder 5 - Paste-Modus an/aus:
wenn eingeschaltet, wird beim Scrollen unter dem Cursor
gezeichnet (ein Ueberbleibsel aus der Zeit, als dieser
Editor noch ohne Mausunterstuezung arbeitete).
K - in den Gesamtkartenmodus wechseln
+ oder - - Verfuegbare Elemente blaetter (+ = Vorwaerts - = Rueckwaerts)
M - in den Mouse-Edit-Mode wechseln
G - an eine bestimmte Position gehen
D oder '.' - Spray on/off:
Spray on: Wenn ein Element gesetzt wird, wird dieses
mit einer 'Spraydose' gestzt.
C - Cycle off/on/auto:
off - Normales Zeichnen
on - Wenn ein Cyclebereich eingestellt ist (cel1-cel2)
wird beim Zeichnen zwischen diesen Elementen
gewechselt. (Dies ist nuetzlich, wenn man z.B.
mehrere Wiesengrafiken hat. Diese werden dann
gewechselt, wodurch die Wiese realistischer wirkt)
auto- Wenn mit #CYCLE ein Cycle-Bereich festgelegt wurde,
dann wird wenn ein Element aus diesem Bereich
gewaehlt wurde, wird das Elementcycle automatisch
auf diese Werte gestellt.
(z.B. Sie haben Wiesengrafiken von der Nummer
3 bis 8, und haben diese mit #CYCLE=1,3,8
festgelegt, dann wird wenn Sie ein Wiesenelement
auswaehlen automatisch auf diesen Bereich geschaltet)
R - Damit koennen Sie die Werte von cel1 und cel2 manuell
festlegen.
Y - Legt die erste Ecke eines Blocks fest
(mit dem Cursor)
X - Legt die zweite Ecke eines Blocks fest (mit dem Cursor)
und zeichnet ihn (falls ein Cyclebereich festgelegt ist,
wird dieser falls moeglich benutzt).
S - Speichert die Landschaft (siehe #MAP)
L - Laedt die Landschaft (siehe #MAP)
N - Hiermit koennen Sie eine neue Landschaft zeichnen
E - Programmende
F - Fast-Mode on/off
Fast-Mode off: Bei Blockoperationen wird die Karte neu
gezeichnet, wodurch der Cycle-Effekt
sichtbar wird.
Fast-Mode on: Nur im Main-Display sind die Auswirkungen
des Elementcycles zu sehen.
T - Speichert eine Landschaft im RAM (siehe #RAMSAVE)
Z - Laedt eine Landschaft aus dem RAM (siehe #RAMSAVE)
U - Macht die vorherige Aktion rueckgaengig (auch Undo kann
man rueckgaengig machen) (siehe #UNDO)
C - Loescht die momentane Landschaft (siehe #INITELEM)
Das Mouse-Edit-Display/Mouse-Edit-Modus:
----------------------------------------
-------------------------------------------------------------------------
| Verfuegbare Grafiken (weiterblaettern der Grafiken mit + oder -, |
| auswaehlen mit der Maus) |
| |
| |
-------------------------------------------------------------------------
| gewaehltes Element --> ** 4,4 <-- Koordinaten |
| | ** Paste off <-- Paste-Funktion aus |
| Auschnitt aus der | Spray off Cycle off <-- Spray und Cycle aus |
| momentanen Landschaft | x1,y1 : 0,0 <-- Koord. der 1. Blockecke |
| | cel1-cel2 : 0-3 <-- Bereich des Elementcycles |
| Zeichnen mit der Maus | -----------------------------------------------
| | |
| | FREI FueR MELDUNGEN |
| | |
| | //// Fast-Modus aktiviert |
| | -FAST------------------------------------------
| | |
| | /// Landschaft wurde veraendert |
---------------------------MOD-------------------------------------------
Tastaturbelegung:
K - s.o
+ oder - - s.o
G - an die Position auf die die Maus zeigt gehen
D oder '.' - s.o
C - s.o
R - s.o
Y - s.o
Allerdings wird die Stelle, auf der Mauszeiger zeigt als
Position benutzt.
X - s.o
S - s.o
L - s.o
N - s.o
E - Mouse-Edit-Mode beenden
F - s.o
T - s.o
Z - s.o
U - s.o
C - s.o
Das Gesamtkarte/Gesamtkarten-Modus:
-----------------------------------
-------------------------------------------------------------------------
| |
| Zeichnen mit der Maus |
| !! Kein Elementwechsel moeglich, aber ideal um Umrisse zu zeichnen |
| |
| |
| |
| |
| |
| |
| |
| |
| |
-------------------------------------------------------------------------
Tastaturbelegung:
G - an die Position auf die die Maus zeigt gehen und
Gesamtkartenmodus beenden
Y - s.o
Allerdings wird die Stelle, auf der Mauszeiger zeigt als
Position benutzt.
X - s.o
S - Speichert die Karte als IFF-Bild ab (siehe #IFFMAP)
E - Gesamtkarten-Mode beenden
U - s.o
HINWEIS: Wenn Sie #NTSC=TRUE gesetzt haben, koennen Sie eine Karte, die
hoeher als 200 Felder ist, nicht vollstaendig anzeigen.
Die Taste 'H' zeigt die Tastaturbelegung an (nicht im Gesamtkarten-Modus).
BUGS ?!
-------
- Da das Programm umprogrammiert wurde, um es auf NTSC-Maße zu schrumpfen,
ist es moeglich, daß aufgrund dieser Aenderung einige Fehler auftreten
(z.B. im Grafikaufbau oder in der Mausabfrage)
EINFUEHRUNG
-----------
Dem Editor liegen Beispielgrafiken im Verzeichnis 'Daten' bei und ist
so konfiguriert, daß Sie es sofort durch einen Doppelklick starten koennen.
Geben Sie auf die Frage 'Convert graphics?' ein 'N' ein, dann kommen
Sie nach kurzem Nachladen in den Haupteditiermodus und koennen dann
sofort loslegen.